home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / language / parallax / sparc_so.tar / sun4sol / README.pz2c < prev   
Text File  |  1993-12-06  |  5KB  |  123 lines

  1. This file decribes how to install the PARZ-Compiler pz2c and how to use it.
  2.  
  3. The "PARZ to C"-compiler is available for the following systems:
  4.  
  5. - SUN-3 (running SunOS Release 4.0 or higher)
  6. - SUN-3 (w/o numeric co-processor)
  7. - SUN-4 (running SunOS Release 4.0 or higher)
  8. - IBM RS-6000 or compatibles
  9. - HP /700 series 
  10. - HP /800 series 
  11. - HP 9000/300 (running HP-UX 7.00 or higher)
  12. - DECStation 2100 or compatibles (running Ultrix V 2.1 or higher)
  13. - VAXStation 3520 or compatibles (running Ultrix V 4.0 or higher) 
  14. - VAX / VMS
  15.  
  16. First of all you have to receive your copy of the PARZ-compiler software package
  17. as decribed in the "Parallaxis Version 2 User Manual".
  18.  
  19.  
  20. Installation
  21. ============
  22.  
  23. 1) uncompress and de-archive the archive file.
  24. 2) copy the executable file 'pz2c' to the local '/usr/local/bin' directory
  25. 3) copy the manual page 'pz2c.l' to the local '/usr/share/man/manl' directory
  26. 4) copy the header file 'pz2c.h' to the local '/usr/include' directory
  27. 5) copy the library file 'libpz2c.a' to the local '/usr/local/lib' directory
  28. 6) run the program "ranlib" on the library file
  29.  
  30. Usage
  31. =====
  32.  
  33. The compiler is started by typing
  34.  
  35.     pz2c {options} inFilename [-o exeFilename]
  36.  
  37. Compiling PARZ programs into C programs gives two advantages:
  38.    *    compiled Parallaxis/PARZ programs are faster than interpreted ones
  39.    *    compiled Parallaxis/PARZ programs are easily portable, 
  40.     since almost every computer system comes with a C compiler.
  41.  
  42. Options start with a '-' sign. All characters after the '-' sign up to the 
  43. next white space are treated as options. A compiler call may contain more 
  44. than one option.
  45.  
  46. The options for both compilers are:
  47.  
  48.  enum        set the maximum number of reported error messages
  49.  m           call the C/MPL compiler for existing code
  50.  O          invoke the optimizer (capital O) of the C/MPL compiler
  51.  p           first run the Parallaxis compiler
  52.  r           remove generated C/MPL source code after compiling it
  53.  t          generate trace information for all PARZ labels 
  54.         (only for debugging)
  55.  v          verbose mode, give information about the compiling
  56.  wnum        set the maximum number of reported warnings
  57.  x         create an identifier cross-reference file. 
  58.         This file will have the extension .ref
  59.  z         don't call the C/MPL compiler after generating the C/MPL 
  60.         source code
  61.  
  62.  
  63. The compiler takes files ending with .z as input files. If the filename entered 
  64. does not have this extension, the compiler adds .z and tries to open this file.
  65.  
  66. If option -p is provided or the inFilename has the extension .p, the Parallaxis 
  67. compiler is invoked with the options -dmnrx, i.e. DEBUG and TRACE commands are 
  68. ignored, no PARZ code for operand-checking in mathematical operations, 
  69. range-check, or NIL-pointer de-referentiation is generated.
  70.  
  71. The name of the generated C program is built by removing the standard extension 
  72. from the inFilename and adding the extension .c to it. The name of the 
  73. generated executable file is normally built by removing the standard extension 
  74. from the inFilename. If option -o exeFilename is provided, this filename is 
  75. used for the executable program.
  76.  
  77. Note, that no DEBUG or TRACE information is supported, i.e. DEBUG and TRACE 
  78. statements in the input file are skipped and a warning is reported.
  79.  
  80. To create a stand-alone executable file, two files are required:
  81.    *    pz2c.h    the C include file
  82.    *    libpz2c.a    the linking library on UNIX systems
  83.  
  84. If you cannot copy these files in the standard search paths for include files 
  85. and libraries, set the environment variables PZ2C_HEADER and PZ2C_LIB to the 
  86. directories, which contain these files. E.g., if the file libpz2c.a resides in 
  87. the directory /home/smith/lib, the variable PZ2C_LIB must have the value 
  88. '/home/smith/lib'.
  89.  
  90.  
  91. In modification to the manual, measured run times will be printed in
  92. a file instead of standard output. The name of this file is built by
  93. removing the extension from the in_filename and adding the extension
  94. '.timing' to it. Each entry in the timing file contains two numbers.
  95. The first is the result of the 'ftime()' system call, the second
  96. is determined by the 'gettimeofday' library routine.
  97.  
  98.  
  99. New Features (Version 2.0.5)
  100. ============================
  101.  
  102. * Using the option '-d', you can force the use of double-precision
  103.   for floating-point variables. The advantage is the higher accuracy, 
  104.   the disadvantage is that floating point computations become slower and 
  105.   each (!) variable requires the size of a 'double' on the machine, 
  106.   typically 8 bytes instead of 4 bytes.
  107.  
  108.   Therefore two libraries exist, one for single-precision (libpz2cs.a) and
  109.   another for double-precision (libpz2cd.a).
  110.  
  111. * The system software was ported to VAX systems running VMS.
  112.   The graphics functions cannot be used under DECwindows.
  113.  
  114.  
  115. Bugs
  116. ====
  117.  
  118. Please send bug reports
  119.  
  120.   To: engelhar@informatik.uni-stuttgart.de
  121.   Cc: braunl@informatik.uni-stuttgart.de
  122.  
  123.